home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 98 / Skunkware 98.iso / src / net / omniORB-2.5.0-src.tar.gz / omniORB-2.5.0-src.tar / omniORB_2.5.0 / README.openvms < prev    next >
Text File  |  1998-03-03  |  4KB  |  114 lines
  1. omniORB2 on OpenVMS platforms
  2. =============================
  3.  
  4. This file contains information on building omniORB2 on OpenVMS (Alpha and
  5. and VAX) platforms.
  6.  
  7. Downloading the distribution
  8. ----------------------------
  9.  
  10. For best results, do the following.
  11.  
  12. Download the .zip version of the distribution directly to your VMS site.  Obtain
  13. the freeware unzip utility from the Digital OpenVMS web site
  14. (http://www.openvms.digital.com/openvms/freeware/freeware.html).  Set your
  15. default location to the top level directory of the distribution.  Unzip the file
  16. [.etc]openvms.zip.
  17.  
  18. Building the distribution
  19. -------------------------
  20.  
  21. This distribution requires the use of MMS.  It has been tested on OpenVMS Alpha
  22. version 6.2 and OpenVMS VAX version 6.1 using DEC C++ version 5.5 and 5.6.
  23.  
  24. The MMS files assume the use of the MMS /Skip qualifier.  You should define a
  25. "make" symbol as follows:
  26.  
  27.     $ make=="mms/skip"
  28.  
  29. Before starting the build, you should configure your system to the platform you
  30. are using by editing the file [.config]config.mms.
  31.  
  32. Next, set your default working directory to [.src] and type:
  33.  
  34.     $ make/macro=(initialize_mms=1)
  35.  
  36. You should now be ready to build. Just type 'make export'.  If you use the
  37. "veryclean" rule you will need to repeat the above initialization step.
  38.  
  39. To build debug versions of the library and/or executables, type:
  40.  
  41.     $ make/macro=(debug=1)
  42.  
  43. This will create libraries and executables with a "d" suffix.  For example,
  44. omniORB2d.olb.
  45.  
  46. Setting up your environment
  47. ---------------------------
  48.  
  49. If your operating system is 6.2 or above, you should add the directory:
  50. mydisk:[myroot.bin.platform] to the logical name DCL$PATH (where platform is
  51. openvms_{alpha|vax}_6_{1|2} and mydisk:[myroot] is the directory containing the
  52. file you are reading).  DCL$PATH should be defined as a search list logical.
  53.  
  54. If your operating system is 6.1 or below, you should define each of the
  55. executables in that directory as foreign commands.  E.g.:
  56.  
  57.     $ omniidl2=="mydisk:[myroot.bin.openvms_vax_6_1]omniidl2.exe"
  58.  
  59. To compile and link against the omniORB2 libraries, you should define the
  60. following logical names:
  61.  
  62.     $ define <qualifiers> omni mydisk:[myroot.include]
  63.     $ define <qualifiers> omniORB2 mydisk:[myroot.include.omniORB2]
  64.     $ define <qualifiers> omniVms mydisk:[myroot.include.omniVms]
  65.     $ define <qualifiers> omnithread mydisk:[myroot.include.omnithread]
  66.  
  67. (Note that the resulting logical names and translations will be in all upper
  68. case.)  With the above definitions in place, you should add
  69. /include=([],omni:)/exceptions to your CXX compiles.  The other logical names
  70. are needed because DEC C++ for OpenVMS does not handle sub-directories of a
  71. directory in the include path properly.
  72.  
  73. You will also need to define the logical OMNICFG to point to an existing
  74. directory for name service configuration information.  The omniNames server
  75. will use this directory.
  76.  
  77. You will need to create a file called "omnicfg:omniorb.cfg" to contain the
  78. nameservice IOR as described in the omniORB2 documentation.  The file
  79. contains the single record:
  80.  
  81. NAMESERVICE <stringified IOR>
  82.  
  83. Once you have created this file, you should startup the omniNames server as a
  84. detached process.  This should be added to your system startup procedure.
  85.  
  86. Notes
  87. -----
  88.  
  89. If you are running OpenVMS version 6.1, please ensure that you have
  90. installed the latest ECOs for the DEC C RTL and C++ Class Library.
  91.  
  92. This release of omniORB2 is incompatable with the backport library supplied
  93. with DEC C++ version 5.6.  Therefore, if your operating system is below 7.0
  94. and you use DEC C++ version 5.6, be sure that the logical name DECC$CRTLMAP
  95. is not defined.
  96.  
  97. Building the examples
  98. =====================
  99.  
  100. You are strongly encouraged to try out the examples provided in
  101. [.src.examples]. Go into [.src.examples] and type 'make all' (where make is
  102. defined as above).
  103.  
  104. Study the documentations in [.doc] (in the omniORB 2.5.0 distribution) before
  105. you run any of the example programs.
  106.  
  107. Documentation
  108. =============
  109.  
  110. You must read the omniORB2 and the OMNI naming service user guides. Follow
  111. the instructions in the guides to complete the configuration process.
  112.  
  113.  
  114.